home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
MrmRegisterNamesInHierarchy.z
/
MrmRegisterNamesInHierarchy
Wrap
Text File
|
1998-10-30
|
8KB
|
133 lines
MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyUUUU((((NNNN3333IIIIXXXXXXXX))))SSSSyyyyssssttttMMMMeeeerrrrmmmmmmmmRRRRVVVVeeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy((((3333XXXX))))
NNNNAAAAMMMMEEEE
MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy - Registers the values
associated with the names referenced in UIL within a single
hierarchy (for example, UIL callback function names or UIL
identifier names)
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Mrm/MrmPublic.h>
CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy(
MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,
MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrAAAArrrrgggglllliiiisssstttt rrrreeeeggggiiiisssstttteeeerrrr____lllliiiisssstttt,
MMMMrrrrmmmmCCCCoooouuuunnnntttt rrrreeeeggggiiiisssstttteeeerrrr____ccccoooouuuunnnntttt);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyfunction registers a vector
of names and associated values for access in MRM. The
values can be callback functions, pointers to user-defined
data, or any other values. The information provided is used
to resolve symbolic references occurring in UID files to
their run-time values. For callbacks, this information
provides the procedure address required by the Motif
Toolkit. For names used as identifiers in UIL, this
information provides any run-time mapping the application
needs.
This function is similar to MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessss, except that
the scope of the names registered by
MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyis limited to the hierarchy
specified by _h_i_e_r_a_r_c_h_y__i_d, whereas the names registered by
MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeesssshave global scope. When MRM looks up a
name, it first tries to find the name among those registered
for the given hierarchy. If that lookup fails, it tries to
find the name among those registered globally.
_h_i_e_r_a_r_c_h_y__i_d
Specifies the hierarchy with which the names are
to be associated.
_r_e_g_i_s_t_e_r__l_i_s_t
Specifies a list of name/value pairs for the names
to be registered. Each name is a case-sensitive,
NULL-terminated ASCII string. Each value is a
32-bit quantity, interpreted as a procedure
address if the name is a callback function, and
uninterpreted otherwise.
_r_e_g_i_s_t_e_r__c_o_u_n_t
Specifies the number of entries in _r_e_g_i_s_t_e_r__l_i_s_t.
Page 1 (printed 10/24/98)
MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyUUUU((((NNNN3333IIIIXXXXXXXX))))SSSSyyyyssssttttMMMMeeeerrrrmmmmmmmmRRRRVVVVeeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy((((3333XXXX))))
The names in the list are case-sensitive. The list can be
either ordered or unordered.
Callback functions registered through
MMMMrrrrmmmmRRRReeeeggggiiiisssstttteeeerrrrNNNNaaaammmmeeeessssIIIInnnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyycan be either regular or creation
callbacks. Regular callbacks have declarations determined
by Motif Toolkit and user requirements. Creation callbacks
have the same format as any other callback:
vvvvooooiiiidddd CCCCaaaallllllllBBBBaaaacccckkkkPPPPrrrroooocccc(
WWWWiiiiddddggggeeeetttt ****wwwwiiiiddddggggeeeetttt____iiiidddd,
OOOOppppaaaaqqqquuuueeee ttttaaaagggg,
XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt ****ccccaaaallllllllbbbbaaaacccckkkk____ddddaaaattttaaaa);
_w_i_d_g_e_t__i_d Specifies the widget ID associated with the widget
performing the callback (as in any callback
function).
_t_a_g Specifies the tag value (as in any callback
function).
_c_a_l_l_b_a_c_k__d_a_t_a
Specifies a widget-specific data structure. This
data structure has a minimum of two members: event
and reason. The reason member is always set to
MMMMrrrrmmmmCCCCRRRR____CCCCRRRREEEEAAAATTTTEEEE.
Note that the widget name and parent are available from the
widget record accessible through _w_i_d_g_e_t__i_d.
RRRREEEETTTTUUUURRRRNNNN
This function returns one of the following status return
constants:
MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS
The function executed successfully.
MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE
The function failed.
Page 2 (printed 10/24/98)